.TH GPTLinitialize 3 "May, 2020" "GPTL"

.SH NAME
GPTLinitialize \- Initialize the GPTL library.

.SH SYNOPSIS
.B C/C++ Interface:
.nf
#include <gptl.h>
int GPTLinitialize (void);
.fi

.B Fortran Interface:
.nf
use gptl
integer gptinitialize ()
.fi

.SH DESCRIPTION
Initializes the GPTL library.

.SH RESTRICTIONS
This function must be called after all calls to
.B GPTLsetoption() 
and
.B GPTLsetutr(),
and before all calls to
.B GPTLstart()
and
.B GPTLstop().
There must be only one call to this routine, so it is better to invoke it
from an unthreaded region.

.SH RETURN VALUE
On success, this function returns 0.
On error, a negative error code is returned and a descriptive message
printed. 

.SH EXAMPLES
.nf         
.if t .ft CW

if (GPTLinitialize () != 0)
  abort();

.if t .ft P
.fi
